home *** CD-ROM | disk | FTP | other *** search
/ Language/OS - Multiplatform Resource Library / LANGUAGE OS.iso / gnu / emacs.lha / emacs-19.16 / vms / VMSINSTALL < prev    next >
Text File  |  1992-11-12  |  5KB  |  115 lines
  1. * Installing GNU Emacs from a VMS install kit
  2.  
  3. If you receive a VMS distribution tape containing an install kit, you can
  4. restore Emacs and run it immediately on any VMS system 4.2 or newer.  The
  5. installation command file will automatically rename certain files whose
  6. names must vary according to the version of VMS in use.
  7.  
  8. However, it is not certain we will have the install kit developed soon, so
  9. until that is done, you may receive an ordinary BACKUP saveset instead.
  10.  
  11. * Installing GNU Emacs from an ordinary VMS BACKUP saveset
  12.  
  13. If you receive a VMS distribution tape in VMS BACKUP interchange format you
  14. can restore Emacs and run it on VMS versions 4.2 or newer after executing a
  15. few commands.  What you must do depends on the VMS version (one procedure
  16. for VMS 4.2 or 4.3; another procedure for newer VMS versions).
  17.  
  18. For VMS versions 4.4 and up, make sure the file SYS$SYSTEM:RIGHTSLIST.DAT
  19. has WORLD:R access.  Emacs reads this file to check file access.
  20.  
  21. [Is this necessary?  I can't find any reference to this in the source.
  22. -rbr, 7 Nov 92]
  23.  
  24. In order to compile Emacs with the VMS C compiler, you will need a pagefile
  25. quota of around 22000 pages, plus enough swap space to handle that.  (This
  26. was in VMS 5.1-1, with 5 meg of physical memory.)  See HELP SYSGEN CREATE
  27. and HELP SYSGEN INSTALL for more information.
  28.  
  29. Choose a directory to restore to, say DEV:[LIB].  Do:
  30.  
  31.     $ mount/foreign mta0:
  32.     $ backup/log mta0: dev:[lib...]
  33.  
  34. Now, if you are using VMS version 4.4 or later, set your default to the
  35. directory DEV:[LIB.EMACS] and run the command file
  36. DEV:[LIB.EMACS.VMS]ALLRENAME.COM:
  37.  
  38.     $ set default dev:[lib.emacs]
  39.     $ @[.vms]allrename [...] "_" "-"
  40.  
  41. This renames all files in the Emacs distribution from their old-VMS names
  42. (containing `_' characters) to their new-VMS names (containing `-' instead).
  43.  
  44. Now execute the command file DEV:[LIB.EMACS.VMS]EMACS.COM.  This defines a
  45. command EMACS that runs a suspendable permanent Emacs.  To fully install
  46. Emacs, you must arrange for users to run this file on login, or arrange for
  47. this file to be run when the system boots.
  48.  
  49. The distribution contains an Emacs executable in DEV:[LIB.EMACS]EMACS.EXE.
  50. It uses DEV:[LIB.EMACS]EMACS.DUMP every time it runs.  The EMACS.EXE has
  51. been linked with the non-sharable C library, so it should run on any VMS
  52. V4.4+ system, whether or not the C compiler exists.  The .OBJ files are all
  53. there, so you can relink with /DEBUG if you want to have fun.
  54.  
  55. A few C source files contain compilation conditionals that depend on the
  56. version of VMS.  We have compiled these files specially for VMS version
  57. 4.2 (or 4.3) in object files with extension .JBO.  So to run on VMS 4.2,
  58. rename all the .JBO files to .OBJ, then link and build Emacs as described
  59. in DEV:[LIB.EMACS.VMS]VMSBUILD.
  60.  
  61.     $ set default [.src]
  62.     $ rename *.jbo *.obj
  63.     $ set default [-.vms]
  64.     $ @link
  65.     $ @build
  66.     $ rename temacs.exe [-]emacs.exe
  67.     $ rename temacs.dump [-]emacs.dump
  68.  
  69. To be clean, you should also edit the file [.SRC]CONFIG.H to #include the
  70. file [.s]VMS4_2.H instead of [.s]VMS-4-4.H.  Then the proper conditionals
  71. will be activated if you ever recompile.
  72.  
  73. * Moving a Unix distribution to VMS.
  74.  
  75. Moving a Unix distribution to VMS is mostly a matter of transferring the
  76. files to the VMS system, but with old versions of VMS (prior to 4.4) it is a
  77. little more complicated because some of the file names used on Unix are not
  78. supported by VMS.  Every `-' in a Unix file name must be changed to a `_' on
  79. VMS.  (In VMS versions 4.4 and up, this is not necessary, since `-' is
  80. allowed in file names.)
  81.  
  82. A few other changes must be made regardless of the version of VMS:
  83.  
  84.  1) Copy the file [.SRC]VMSPATHS.H to [.SRC]PATHS.H, replacing any existing
  85.     file PATHS.H in that directory.
  86.  
  87.  2) Delete any file [.SRC]CONFIG.H and replace it with a copy of
  88.     CONFIG.H_IN.  Then edit this file so it specifies `[.m]vax.h' as the 
  89.     second include file and for the first include file one of
  90.     `[.s]vms4-0.h', `[.s]vms4-2.h' or `[.s]vms4-4.h'.  (Use the highest
  91.     version not greater than the VMS version you are running.  For VMS
  92.     versions prior to 4.4, the `-' characters must be replaced with `_'.) 
  93.  
  94. You can now compile, link, build and install Emacs as described in
  95. [.VMS]VMSBUILD..
  96.  
  97. * Moving a VMS distribution to Unix.
  98.  
  99. Delete all .OBJ files, and PATHS.H and CONFIG.H.  Then copy the remaining
  100. files, changing each `_' in a file name to `-`.  Unix will allow filenames
  101. with `_' but Emacs will not work with them!
  102.  
  103. Names which on VMS end in a period (have a null extension) should have no
  104. period on Unix.  Thus, "YMAKEFILE." becomes "ymakefile".
  105.  
  106. VMS file names are case-insensitive.  On Unix, case is significant.  Most of
  107. the file names must be in lower case or they will not work.  There are only
  108. a few exceptions:
  109.  
  110.  1) CHANGELOG. becomes ChangeLog
  111.  2) MAKEFILE. becomes Makefile
  112.  3) TAGS. becomes TAGS
  113.  4) Files of English text with null extensions keep their names in upper
  114.     case.  For example, README. becomes README and [.ETC]GNU. becomes GNU
  115.